home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / os2mb106.zip / Readme.1st < prev    next >
Text File  |  1997-05-27  |  19KB  |  502 lines
  1. This is the readme.1st file for RXDbase and MaxBase.
  2. Please read all of it before installing or upgrading.
  3.  
  4. NOTE: Please see the end of this document to read about 
  5. the license for this package.
  6. RXDbase is *not* freeware (though it is cheap!).
  7.  
  8. NOTE2: When you find errors in any of the applications 
  9. in this package, please report them to maxmars@pianeta.it, 
  10. along with the error dump (you can find that in the shell 
  11. where you have launched the program) and an explanation
  12. of what you were doing.
  13.  
  14.  
  15. HOW TO GET 'LATEST AND GREATEST'
  16. "'"'"'"'"'"'"'"'"'"'"'"'"'"'"'"'
  17.  
  18. The web page for maxbase can be found at:
  19.  
  20. *************************************************
  21. http://www.bmtmicro.com/catalog/mb-web
  22. (BMT-Micro in USA, with secure online order form)
  23. *************************************************
  24.  
  25. *************************************************
  26. http://www.ososoft.com/RXDBASE.HTM
  27. (OsoSoft in Italy, with plain online order form)
  28. *************************************************
  29.  
  30. You can get MaxBase from any of the two.
  31.  
  32.  
  33.  
  34. UPDATING
  35. "'"'"'"'
  36.  
  37. Users updating from earlier versions of MaxBase 
  38. should shut down any MaxBase instance which is
  39. running and unzip this file into the existing 
  40. MaxBase directory.
  41. If changes to the installation program are listed 
  42. in the differences from earlier releases (paragraph
  43. below) please re-run install.cmd.
  44.  
  45.  
  46.  
  47. DIFFERENCES FROM 1.05
  48. "'"'"'"'"'"'"'"'"'"'"
  49.  
  50. .) Speeded up most filter operations.
  51. .) Added the possibility to choose which fields to show and their
  52.    order.
  53. .) Added a pointer to the main panel from panels which are more than
  54.    one level away from the main panel.
  55. .) Added information on currently added/modified record,
  56.    and total number of records in add/modify sections.
  57. .) Added registration information / program information
  58.    in the (new) 'about' section.
  59. .) Minor (but useful) changes to the add/modify section:
  60.    CTRL+PGUP/PGDN now changes page when there are 6 or more
  61.    fields; UP and DOWN key arrows now move cursor up/down
  62.    one field; when pressing PGDN/DOWNN while on the 5-th field 
  63.    in a 6 or more fields database the page automatically changes
  64.    to the next page. (PGUP/UP work similarly for the first field)
  65. .) Changed the font of the non-record list from fixed bold font to
  66.    whatever the user chose in the fonts/color section.
  67. .) Changed: when logging out from a database, if no colors/fonts are 
  68.    defined for that database diectory, the current colors/fonts are
  69.    saved.
  70. .) Corrected a severe error in the indexing routines: if you ran into
  71.    problems with MaxBase 1.05 (and/or possibly 1.04 as well) please
  72.    delete all the *.idx files and reload the DB. The problem should
  73.    go away.
  74. .) Corrected: database creation always defaulted to the current
  75.    directory (and always created databases there).
  76. .) Corrected: CTRL+B didn't work on filter section.
  77. .) Corrected: MaxBase was crashing while loading a DB under certain 
  78.    circumstances.
  79. .) Corrected: when exiting from MaxBase, .ini information for that 
  80.    directory don't get overwritten if values aren't different from 
  81.    default are in use.
  82. .) Corrected: Sportello didn't handle too well customized menus.
  83. .) Corrected: Minor filter failures.
  84.  
  85.  
  86. ACKNOWLEDGMENTS
  87. "'"'"'"'"'"'"'"
  88.  
  89. Many thanks to Giuseppe Aprile for his great .dbf <---> .dat conversion
  90. utilities. Also thanks to all the testers who have helped me while I
  91. was (but I still am and will be!) developing MaxBase.
  92. Thanks saCUL, Penny and all the others!
  93.  
  94.  
  95. INSTALLATION AND FIRST STEPS
  96. "'"'"'"'"'"'"'"'"'"'"'"'"'"'
  97.  
  98. Warning: you need long file names to use this product. 
  99. (HPFS disks only, please)
  100.  
  101. Warning/2: this program heavily depends on the quality of your Java VM.
  102. Please get and install the latest release of the Java VM for your
  103. computer/Operating System before running MaxBase.
  104.  
  105. I have included an install batch file for OS/2, 
  106. it is called install.cmd and you should find it in this very same 
  107. directory. 
  108.  
  109. [If you're an user from another operating system you should really 
  110. download the genmb105.zip file, not this one]
  111.  
  112.  
  113. 1. If you are not a Java or NetRexx programmer.
  114.  1.1 QuickStart for MaxBase local version.
  115.  1.2 QuickStart for MaxBase networked version.
  116.  1.3 Publishing databases on the World Wide Web.
  117.  
  118. 2. If you are a Java/NetRexx programmer.
  119.  2.1 Where to go from here now (library for local database)?
  120.  2.2 Where to go from here now (library for networked databases)?
  121.  2.3 Where to go from here now (plugins for MaxBase)?
  122.  
  123.  
  124. 1. If you are not a Java or NetRexx programmer:
  125.  
  126. 1.1 QuickStart for MaxBase local version:
  127.     ---------- --- ------- ----- --------
  128.  
  129. Just unzip plugins.zip (or MACplug, UNIXplug if you use Macs or Unices), then
  130. type 'java MaxBase' and, via the GUI, connect to the database "imgs.dat".
  131. Select one or all of the entries in the database and click on the
  132. "view text/image" button.
  133. runme.cmd, runme.bat batch files are provided for OS/2 and Windows users.
  134. If you are a user from another system or machine, and have created a batch
  135. file to automatize the launch of MaxBase (local DB app) and/or Sportello
  136. (networked DB app, client side), RXDBServer (networked DB app, server side)
  137. please e-mail it to me at maxmars@pianeta.it.
  138.  
  139.  
  140. 1.2 QuickStart for MaxBase networked version:
  141.     ---------- --- ------- --------- --------
  142.  
  143. To run the server, you need to  use the batch files (runserver.cmd and
  144. runserver.bat) to put the server to work.
  145. If you launch RXDBServer.class without parameters, it will show you
  146. its usage. Eg. type "java RXDBServer" at the command prompt.
  147. ['runserver' is a batch file which issues 'java RXDBServer <parameters>']
  148.  
  149. To run the client, just launch runclient.cmd or runclient.bat giving as a
  150. parameter the IP address of the machine which has an RXDBServer running,
  151. the port on which that server is running and (optional) the password for
  152. the server. Without a password, you will be able only to browse the remote
  153. database (but only if the remote server is operating in safe mode).
  154. Beware that in most Java implementations you cannot use dotted decimal
  155. IP notation (unless you have some kind of host resolution hardiwred, as in
  156. OS/2 Warp 4's C:\MPTN\ETC\HOSTS file)
  157. ['runclient' is a batch file which issues 'java Sportello <parameters>']
  158.  
  159. For example, I have set up my machine to act as 10.0.0.1, and when I
  160. do my tests I fire up the server then I launch "runclient.cmd 10.0.0.1".
  161.  
  162.  
  163. 1.3 Publishing databases on the World Wide Web.
  164.     ---------- --------- -- --- ----- ---- ----
  165.  
  166. Please refer to the SportelloApplet.doc file into the "client" directory
  167. to learn how to publish your databases on the web (warning: in that
  168. document it is assumed that you know how to mantain a web page).
  169.  
  170.  
  171.  
  172.  
  173. 2. If you are a Java/NetRexx programmer:
  174.  
  175. Warning:
  176. ----------------------------------------------------------------------
  177. this package was created using NetRexx, a compiler (written in Java) which generates
  178. Java code. The programs generated by it (and all the programs here are such)
  179. need the NetRexx classes. A copy of these is here in this package,
  180. file NetRexxR.zip. Just copy NetRexxR.zip in a directory that's in your
  181. CLASSPATH environment variable, and you're OK (no need to unzip them).
  182. Be sure to have .\. (./. or whatever your OS needs) in the classpath environment
  183. variable.
  184.  
  185. More NetRexx info on my page or at http://www2.hursley.ibm.com
  186.  
  187. Read also the file 'license.txt' in the netrexx\lang directory that resides in
  188. NetRexxR.zip, because it contains the user license for those NetRexx classes.
  189. License.txt doesn't apply to RXDbase and MaxBase, though: for those two, refer
  190. to the .doc accompanying them.
  191.  
  192. From version 0.9 I've started using Taligent widgets. See Talicense.txt
  193. for the license.
  194. ----------------------------------------------------------------------
  195.  
  196. If you're interested in plugins for MaxBase and are using WinXX or OS/2, please
  197. unzip the file plugins.zip.
  198. If you are using a Mac unzip macplug.zip, and finally for Unix unzip unixplug.zip.
  199. Those packages differ for the included databases (in WinXX and OS/2 you have
  200. newline = \r\n, in Mac = \r and in Unix = \n) and plugin.ini.
  201.  
  202.  
  203. 2.1 Where to go from here now (library for local database)?
  204.     ----- -- -- ---- ---- --- -------- --- ----- ---------
  205.  
  206. The file to read is RXDbase.doc. I have also put here some examples
  207. (dbtest.nrx and dbtest2.nrx) which are coded in NetRexx.
  208.  
  209.  
  210. 2.2 Where to go from here now (library for networked databases)?
  211.     ----- -- -- ---- ---- --- -------- --- --------- ----------
  212.  
  213. The Networked, client side classess for RXDbase come in the form of RXDBClient.doc
  214. in the .\client directory. There are no server side classes or APIs since it's
  215. all handled by the server.
  216.  
  217.  
  218. 2.3 Where to go from here now (plugins for MaxBase)?
  219.     ----- -- -- ---- ---- --- -------- --- ---------
  220.  
  221. Readme.plugins is the place where to start to learn more about plugins.
  222.  
  223. MaxBase can be customized with little effort by means of plugins.
  224. Plugins are small Java or NetRexx applications which communicate
  225. with MaxBase to get the list of fields and records which were
  226. selected at the moment that the user launched the plugin, and then
  227. do specific tasks.
  228.  
  229. Let's see it a bit better:
  230.  
  231. 1) The user selects some records in MaxBase.
  232. 2) The user pushes a plugin button from within
  233.    MaxBase, thus launching a plugin.
  234. 3) MaxBase fires up the plugin, and waits until
  235.    the plugin has finished initializing itself.
  236. 4) MaxBase sends the plugin info about the fields
  237.    of the current DB and the records which are selected.
  238. 5) Now it's up to the plugin: it can do whatever it wants
  239.    with those data.
  240.  
  241.  
  242. PLATFORM CONSIDERATIONS
  243. "'"'"'"'"'"'"'"'"'"'"'"
  244.  
  245. I did test this program only on OS/2 Warp 4 and Win32.
  246. If you're using it under other platforms, please drop
  247. me a note on your results with it.
  248.  
  249.  
  250. PLEASE BE VOCAL
  251. "'"'"'"'"'"'"'"
  252.  
  253. Yes, I need _your_ feedback on errors, incompatibilites, suggestions, etc.
  254. So far I'm testing it only on the OS/2 platform (and some
  255. tests are done also on Win32). I'd be interested on
  256. feedback also from users of other O.Ss. and platforms.
  257.  
  258.  
  259. LICENSE
  260. "'"'"'"
  261.  
  262. Why should you register?
  263. Because this way you:
  264.  
  265. A) Receive (via e-mail or snail mail) the uncrippled
  266.    version of MaxBase.
  267. B) Receive for free all the updates up to version 2 for
  268.    MaxBase. [Note: bug-fixes are always seen as 1.X,
  269.    and so do most of the improvements until the program
  270.    is really different from version 1.0, and this won't
  271.    happen in 1997 anyway - I plan to release 1 major
  272.    release for year, with discounts for people who
  273.    already have an older version].
  274. C) Help the author decide that the developing of MaxBase
  275.    is a worthy cause, so he will be encouraged to add
  276.    many enhancements to it. :-)
  277.  
  278.  
  279.  
  280. With "program", it is intended the whole set of .class files included
  281. in this package.
  282.  
  283. If you have received this program as shareware, be warned that you
  284. have a period of 30 days to evaluate it, then you must choose:
  285.  
  286. 1) if you want to continue using this product, you must pay for it.
  287.  
  288. MaxBase can be registered via BMT-Micro - please see the end of the
  289. document.
  290.  
  291.  Register fees are:
  292.   US Dollars   29 .. for the standard edition (full local database
  293.                       + server able to receive 2 clients at once)
  294.   US Dollars   89 .. for the extended edition (full local database
  295.                       + server able to receive all the clients
  296.                       it can handle at once)
  297.  
  298. 2) if you don't like this program, or are unable to contact the author,
  299. you *must* stop using the program and you *must* uninstall it after the
  300. 30 days period.
  301.  
  302. 3) If you build an application with RXDbase, a *small* one-time fee
  303. must be paid to the author (contact me for details).
  304.  
  305. 4) Non profit organizations: please contact me for details; discounts
  306. are available.
  307.  
  308. I am not responsible or liable in any way for any damages
  309. deriving from the use of this product. Use it at your own risk.
  310.  
  311. The sources for RXDbase are not provided, and you cannot modify or disassemble
  312. the class, in any way. Also, you can not re-distribute this program unless
  313. you have the permission of the author (Max Marsiglietti).
  314.  
  315. RXDBase is (c) Max Marsiglietti 1996, 97.
  316.  
  317. See Also Talicense.txt (in the directory where you found this) and license.txt
  318. inside NetRexxR.zip.
  319.  
  320.  
  321.  
  322. CONTACTING THE AUTHOR
  323. "'""'"'"'""'"'"'""'"'
  324.  
  325. If you find any bug, or have suggestions, please
  326. report all of your comments to:
  327.  
  328.  Max Marsiglietti,
  329.  
  330.  E-mail:
  331.   maxmars@pianeta.it (Internet), 2:332/529.12 (Fidonet)
  332.  
  333.  Snail Mail:
  334.   V.Landino 13,
  335.   41049, Sassuolo (MO)
  336.   Italy.
  337.  
  338.  
  339. REGISTERING VIA BMT - MICRO
  340. "'"'"'"'"'"'"'"'"'"'"'"'"'"
  341.  
  342.                   Mail Orders To: BMT Micro
  343.                                   PO Box 15016
  344.                                   Wilmington, NC 28408
  345.                                   U.S.A.
  346.  
  347.                     Voice Orders: 8:00am - 7:00pm EST (-5 GMT)
  348.                                   (800) 414-4268 (orders only)
  349.                                   (910) 791-7052
  350.  
  351.                       Fax Orders: (910) 350-2937  24 hours / 7 Days
  352.                                   (800) 346-1672  24 hours / 7 Days
  353.  
  354.          Online Orders via modem: (910) 350-8061  10 lines, all 14.4K
  355.                                   (910) 799-0923  Direct 28.8K line
  356.  
  357.                     via Internet: orders@bmtmicro.com
  358.                                   telnet@bmtmicro.com
  359.                                   http://www.bmtmicro.com
  360.      Secure Ordering: https://wwws.wilmington.net/bmtmicro/secure_form.html
  361.  
  362.  
  363.      Ordering and general ordering questions:
  364.  
  365.                             Via AOL: bmtmicro
  366.                             Via MSN: bmtmicro
  367.                          Via Prodigy: HNGP66D
  368.                     Via Compuserve: 74031,307
  369.  
  370.  
  371.      We accept Visa, Mastercard, Discover, American Express, Diners
  372.      Club, Carte Blanche, Cashiers Check, Personal Check.   Personal
  373.      checks are subject to clearance.  Eurochecks in DM are welcome.
  374.      DM, Sterling, and US Currency is welcome but send only by
  375.      registered mail, return receipt requested.   We cannot be liable
  376.      for lost cash sent through the mail.
  377.  
  378.      If you reside in a country with an unconvertible currency please
  379.      contact us for alternatives.
  380.  
  381.      Purchase orders are welcome, subject to approval.   The minimum
  382.      amount is $250.00.
  383.  
  384.      Information for our German customers is explained in the last
  385.      paragraph of this order form.
  386.  
  387.      _____________________________________________________________________
  388.  
  389.      Company:_____________________________________________________________
  390.  
  391.      Name:________________________________________________________________
  392.  
  393.      Address:_____________________________________________________________
  394.  
  395.              _____________________________________________________________
  396.  
  397.      City: _______________________________State/Province: ________________
  398.  
  399.      Postal/ZIP Code: ____________________Country:________________________
  400.  
  401.      Phone:_______________________________________________________________
  402.  
  403.      Fax:  _______________________________________________________________
  404.  
  405.      E-Mail #1____________________________________________________________
  406.  
  407.      E-Mail #2____________________________________________________________
  408.  
  409.  
  410.      Product                    Quantity Price  Number of copies
  411.      _________________________  ______________  ________________
  412.  
  413.      _________________________  ______________  x ____________ = + $ _______
  414.  
  415.      _________________________  ______________  x ____________ = + $ _______
  416.  
  417.      _________________________  ______________  x ____________ = + $ _______
  418.  
  419.      Latest Version on Diskette _____$3.00____  x ____________ = + $ _______
  420.  
  421.  
  422.      North Carolina Residents add 6% Sales Tax                     $ _______
  423.  
  424.      Shipping and Handling (no quantity limit / see below)         $ _______
  425.  
  426.        Email - Subject to Credit Card Verification     Free
  427.        Fax (USA/Canada)...........................     1.00 US
  428.        Fax (Non-North America)....................     2.00 US
  429.        Worldwide 1st Class .......................     Free
  430.        2nd Day Priority, USA Only ................ $   4.00 US
  431.        US Postal Service International Express
  432.          (Including Canada and Mexico), allow up to
  433.          7-10 days ............................... $  25.00 US
  434.        Airborne Select Delivery  (USA Only)        $   8.00 US
  435.        FedEx Overnight, USA Only (delivery by
  436.          3:00 pm the following day) .............. $  15.00 US
  437.        FedEx Europe/Japan (guaranteed delivery
  438.          within 3 days) .......................... $  35.00 US
  439.  
  440.  
  441.      Total:                                                      $ _______
  442.  
  443.  
  444.       For credit card payment only
  445.  
  446.       Circle one: VISA / Master / Discover / American Express / Diners
  447.  
  448.       Credit card number: _____________________________________________
  449.  
  450.       Expiration date: ________________________________________________
  451.  
  452.       Authorization signature: ________________________________________
  453.  
  454.  
  455.  
  456.                    ORDERING FROM INSIDE GERMANY ONLY
  457.                    =================================
  458.  
  459. Persons in Germany wishing to order shareware may also transfer funds
  460. into our account with Deutsche Bank.   Once the money is deposited you
  461. may either fax a confirmation to us with proof of deposit or wait until
  462. Deutsche Bank notifies us of the transaction (usually 10-18 business days).
  463. Account information is as follows:
  464.  
  465. Deutsche Bank / Frankfurt Branch
  466. Empf║nger:  Thomas Bradford
  467. Konto-Nummer: 0860221
  468. Bankleitzahl: 500-700-10
  469.  
  470. When you make the transfer, be sure to put your name and the program you
  471. are registering on the transfer.
  472.  
  473. Current exchange rates can be obtained by sending an email to
  474. dm_to_us@bmtmicro.com.   An automated reply will return todays exchange
  475. rates.
  476.  
  477. It is very important that you send us a completed order form by
  478. either email or fax if you deposit money into this account for a
  479. registration.  Fill the order form out as usual except in the credit
  480. card number field put "DEUTSCHE BANK".   We will file the order and
  481. use it to match against the deposit information we receive from the
  482. bank.
  483.  
  484.                                IMPORTANT!
  485.                                ----------
  486. When you email us your order form, we will reply with an
  487. acknowledgement.   If you do not get an acknowledgement within 24 hours
  488. please send your order again in case it was lost.  This extra bit of
  489. caution can save a lot of confusion.
  490.  
  491. If you are concerned that your order is taking too long to process, feel
  492. free to check with us about the status of your order.   It's important
  493. to all of us that you feel safe doing business with our company and
  494. please feel free to suggest ways we can improve our service to you.
  495.  
  496.  
  497.  
  498.  
  499. Ciao and thanks for your time!
  500. Max.
  501.  
  502.